4.5.5.1 应用授权-基于id
可通过此接口基于应用 id 将指定应用授权给用户，组织架构或角色。
基本信息：
请求地址：
https://SDPC-IP:4433/api/v3/resource/assignById请求方式：
POST
请求头（Header）：
- 请求体（Body）：
| 参数 | 中文名称 | 必须 | 类型 | 描述 |
|---|---|---|---|---|
| id | 应用id | 是 | string | |
| op | 操作方式 | 否 | string | 操作类型。 取值范围： append-追加更新（默认）reset-重置delete-删除。 |
| data | 授权对象 | 否 | object | 不传该字段等效于data为空object，即data: {} |
| ├─ user | 用户 | 否 | object[] | 用户 |
| ├─├─ directoryDomain | 目录唯一标识 | 否 | string | 用户目录唯一标识，为用户授权应用权限时为必传字段 |
| ├─├─ id | 用户 id | 否 | string | 用户 id ，基于 id 为用户授权应用权限时为必传字段 |
| ├─├─ name | 用户 name | 否 | string | 用户 name ，基于 name 为用户授权应用权限时为必传字段 |
| ├─├─ externalId | 用户外部 id | 否 | string | 用户外部 id ，基于外部 id 为用户授权应用权限时为必传字段 |
| ├─├─ effectiveTime | 生效时间 | 否 | string | 生效时间戳 示例：1709304051000 |
| ├─├─ expireTime | 过期时间 | 否 | string | 过期时间戳 示例：1709304051000 |
| ├─ userGroup | 组织架构 | 否 | object[] | 组织架构 |
| ├─├─ directoryDomain | 目录唯一标识 | 否 | string | 用户目录唯一标识，为组织架构授权应用权限时为必传字段 |
| ├─├─ id | 组织架构 id | 否 | string | 组织架构 id ，基于 id 为组织架构授权应用权限时为必传字段 |
| ├─├─ fullPath | 组织架构全路径 | 否 | string | 组织架构全路径 ，基于 fullPath 为组织架构授权应用权限时为必传字段 |
| ├─├─ externalId | 外部 id | 否 | string | 组织架构外部 id ，基于外部 id 为组织架构授权应用权限时为必传字段 |
| ├─├─ effectiveTime | 生效时间 | 否 | string | 生效时间戳 示例：1709304051000 |
| ├─├─ expireTime | 过期时间 | 否 | string | 过期时间戳 示例：1709304051000 |
| ├─ userBand | 角色 | 否 | object[] | 角色 |
| ├─├─ directoryDomain | 目录唯一标识 | 否 | string | 用户目录唯一标识，为角色授权应用权限时为必传字段 |
| ├─├─ id | 角色 id | 否 | string | 角色 id ，基于 id 为角色授权应用权限时为必传字段 |
| ├─├─ name | 角色 name | 否 | string | 角色 name ，基于 name 为角色授权应用权限时为必传字段 |
| ├─├─ externalId | 外部 id | 否 | string | 角色外部 id ，基于外部 id 为角色授权应用权限时为必传字段 |
| ├─├─ effectiveTime | 生效时间 | 否 | string | 生效时间戳 示例1709304051000 |
| ├─├─ expireTime | 过期时间 | 否 | string | 过期时间戳 示例：1709304051000 |
- 请求示例：
curl --location --request POST 'https://SDPC-IP:4433/api/v3/resource/assignById' \
--header 'Content-Type: application/json' \
--header 'X-Ca-Key: {{X-Ca-Key}}' \
--header 'X-Ca-Nonce: {{X-Ca-Nonce}}' \
--header 'X-Ca-TimeStamp: {{X-Ca-TimeStamp}}' \
--header 'X-Ca-Sign: {{X-Ca-Sign}}' \
--data-raw '{
"id": "79e9d460-d317-11ee-af95-6561ff99b387",
"op": "reset",
"data": {
"user": [
{
"directoryDomain": "local",
"name": "hzm",
"effectiveTime": "1709646812000",
"expireTime": "1709913599999"
}
],
"userGroup": [
{
"directoryDomain": "local",
"fullPath": "/root/a",
"effectiveTime": "1709646812000",
"expireTime": "1709913599999"
},
{
"directoryDomain": "custom51327",
"fullPath": "/custom组织架构",
"effectiveTime": "1709646812000",
"expireTime": "1709913599999"
}
],
"userBand": [
{
"directoryDomain": "wechat99564",
"name": "juese",
"effectiveTime": "1709646812000",
"expireTime": "1709913599999"
}
]
}
}'
- 返回数据：
| 参数 | 中文名称 | 类型 | 描述 |
|---|---|---|---|
| code | 响应码 | string | OK 表示成功，其他表示出错。具体含义请参考错误码定义 |
| data | 响应数据 | object | 响应数据 |
| msg | 描述信息 | string | 描述信息 |
| traceId | 调用链id | string |
- 响应示例
{
"code": "OK",
"data": {},
"msg": "请求成功",
"traceId": "00b27e69598c3483"
}
错误码